home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / serial / zyxel-1.5-s / zyxel-1 / README < prev    next >
Text File  |  1995-01-29  |  7KB  |  180 lines
  1. **
  2. **       #########         #       # ######### #
  3. **              #           #     #  #         #
  4. **            ##   #     #   #   #   #         #
  5. **           #     #     #    ###    #######   #
  6. **         ##      #     #   #   #   #         #
  7. **        #        #     #  #     #  #         #
  8. **       #########  ###### #       # ######### #########
  9. **                       #
  10. **                       #
  11. **                  #####
  12. **
  13.  
  14. This program is copyrighted by:
  15.    R.E. Janssen
  16.    Prof L Fuchslaan 8
  17.    3571 HC  UTRECHT, NETHERLANDS
  18.  
  19. Permission is granted only for noncommercial use.  Any commercial use or
  20. distribution via commercial services without the author's permission is
  21. prohibited.
  22.  
  23.  
  24. This source version of ZyXEL is not sufficient to get the program working.
  25. You need to get the binary version as well, as it includes the documentation
  26. and example configuration files, as well as some recorded voice.
  27.  
  28. To re-compile the program from source, install these files in any
  29. directory (but not /usr/ZyXEL):
  30.     README
  31.     Makefile.SVR4
  32.     Makefile.linux
  33.     zyxel.c
  34.     alphasort.c
  35.     scandir.c
  36.     usleep.c
  37.     hplay.c
  38.     rsynth-2.0-diffs
  39.     zplay/
  40.     zplay/zplay.c
  41.     zplay/dsp.c
  42.     zplay/dsp.h
  43.     zplay/Makefile
  44.     zplay/README
  45.  
  46. "alphasort", "scandir" and "usleep" are provided for systems that don't
  47. have them in the C library.  Linux does not need them.
  48.  
  49. Make a link or copy of the Makefile most suitable for your system as
  50. "Makefile" and check it.
  51.  
  52. Also on Linux, make sure the following symbolic links are present in
  53. /usr/include:
  54.     /usr/include/asm -> /usr/src/linux/include/asm
  55.     /usr/include/linux -> /usr/src/linux/include/linux
  56.                           ^^^^^^^^^^^^^^^
  57.     (or to wherever you keep your Linux kernel sources)
  58. The Linux kernel sources, or at least the include subdirectory of it, are
  59. required for compilation.
  60.  
  61. Now, a "make" will compile the program, and "make install" will install it.
  62. (you need to be logged in as "root" to do the "make install")
  63. Make sure the destination directory (BIN= line in the Makefile) matches
  64. your system setup.
  65.  
  66. You may get some warnings from the compiler.  The following are known
  67. to be given by GCC version 2.5.8:
  68.  In function `playback':
  69. ####: warning: passing arg 3 of `scandir' from incompatible pointer type
  70.  In function `expect':
  71. ####: warning: variable `expfail' may be clobbered by `longjmp' or `vfork'
  72. ####: warning: variable `retval' may be clobbered by `longjmp' or `vfork'
  73. ####: warning: variable `oldalarm' may be clobbered by `longjmp' or `vfork'
  74.  
  75. The first of these warnings is caused by differences in declaration of
  76. scandir between different versions of include files (<dirent.h> in this case).
  77. I don't have any idea what the latter 3 warnings mean, and what could be
  78. done to improve the code so they don't occur.  They were introduced by some
  79. 2.5.x version of GCC.
  80. If you get other warnings, checkout what is happening. (e.g. missing include
  81. files, missing declarations, etc. probably mean your include files need
  82. updating or the abovementioned symlinks are not correctly set)
  83.  
  84.  
  85. There are some configurable items near the beginning of the source.  One
  86. is of interest to users of ZFAX.  This program runs only under DOS or
  87. DOSEMU, but it allows conversion from and to FAX file format without
  88. using the ridiculous amounts of memory the UNIX-based tools require.
  89.  
  90. The default is to support CLASS 2:
  91. #undef    ZFAX                /* use AT# FAX commands (vs CLASS 2) */
  92.  
  93. To support ZFAX-style FAX files, hange this to: #define ZFAX
  94.  
  95.  
  96. To re-compile the speech synthesizer, you will have to get the
  97. rsynth-2.0 sources (these are not included in this source kit).
  98. They are available from svr-ftp.eng.cam.ac.uk as:
  99. comp.speech/sources/rsynth-2.0.tar.gz
  100.  
  101. Unpack this tarfile in the directory where you have stored the ZyXEL
  102. sourcefiles, to get an rsynth-2.0 subdirectory.  "cd" to that directory,
  103. and use "./configure" to configure the program.  Then, remove the
  104. "hplay.c" file and replace it with the "hplay.c" included with the ZyXEL
  105. sources.  Now "cd" back up to the ZyXEL source directory, and apply the
  106. patches in rsynth-2.0-diffs using "patch -p0 -s <rsynth-2.0-diffs".
  107. Type "make" to compile everything, including the speech synthesizer
  108. (followed by "make install" when you wish to install the result)
  109.  
  110.  
  111. To get updated versions of this program, call my system using UUCP.
  112. Please note that it is only available from 23:00 to 07:30 local time,
  113. which is GMT+1 during winter, GMT+2 during summer (DST).
  114.  
  115. You need a description for my system in your "systems" file.  Often this
  116. file is called /usr/lib/uucp/Systems, or /usr/lib/uucp/L.sys on older
  117. systems.  For the Taylor-UUCP which is normally used with Linux, this
  118. can be the file /usr/lib/uucp/sys (when Taylor-style configuration
  119. files are being used).
  120.  
  121. The entry for my system should look like this:
  122.  
  123. pe1chl Any2305-0725 ACU 19200 030715610 ogin:-\r-ogin:-\r-ogin: nuucp
  124.  
  125. Or in Taylor-UUCP format:
  126.  
  127. # Rob PE1CHL
  128. system pe1chl
  129. port ACU
  130. phone 030715610
  131. time Any2305-0725
  132. chat ogin:-\r-ogin:-\r-ogin: \d\L
  133. call-login nuucp
  134.  
  135. These entries make sure the system is called only at the appropriate
  136. time (i.e. when it is open).  Please make sure you don't use "Any" because
  137. your system will call me all the time when I am using the phone for
  138. voice!  Also adjust the time range when you are not in the same timezone
  139. as I am.  Add one hour for each timezone you live east of my timezone, or
  140. subtract one hour for each timezone you live west.
  141.  
  142. You may have to modify the phone number to adjust for local conventions
  143. (e.g. to get an outside line or to dial the international prefix and 31)
  144.  
  145. When everything is set up okay, you can get one of the INDEX files which
  146. is available in my uucppublic directory:
  147.  
  148. -rw-r--r--   1 guest    visitor     30207 Jul  1 23:00 INDEX
  149. -rw-r--r--   1 guest    visitor      6481 Jul  1 23:00 INDEX.gz
  150. -rw-r--r--   1 guest    visitor      6573 Jul  1 23:00 INDEX.lzh
  151.  
  152. These files are updated automatically each day, and contain a listing
  153. of all available subdirectories.  The .gz file is compressed using "gzip",
  154. the .lzh file is in the format written by the DOS LHA program, and has
  155. the file in DOS textfile convention.
  156.  
  157. Get a file using:
  158.  
  159.     uucp pe1chl!~/INDEX /tmp/pe1chl-INDEX
  160.  
  161. You may need to add a \ before the ! and the ~, depending on the shell
  162. you are using, so that the command becomes:
  163.  
  164.     uucp pe1chl\!\~/INDEX /tmp/pe1chl-INDEX
  165.  
  166. Further files may be download using:
  167.  
  168.     uucp pe1chl!~/subdirectory/filename /tmp/filename
  169.  
  170. You can upload something using:
  171.  
  172.     uucp filename pe1chl!~/upload/filename
  173.  
  174. (uploads are only possible to the ~/upload directory)
  175.  
  176. Please send mail to pe1chl!rob when you have questions or remarks.
  177. (for now, you can also email to pe1chl@wab-tis.rabobank.nl, but I don't
  178. know how long that address will remain valid.  when it bounces try
  179. rob@knoware.nl)
  180.